Singularity is an extension to Black Hole. Singularity lets you partly
integrate Black Hole's wastebin functions with the RISC OS Filer's functions.

If you have Black Hole running, then there are two ways you can delete a
file:

 1) You can drag the icon for the file from the directory viewer to the Black
    Hole icon. The file will be deleted subject to Black Hole's options. The
    wastebin part of Black Hole will keep a copy of the file if you have
    configured it to do so.
 
 2) You can click the MENU button over the file's icon and select 'Delete'
    from the Filer menu which appears. This will delete the file but Black
    Hole will not know about this and so the wastebin part of Black Hole will
    not be able to keep a copy.
    
This is where Singularity comes in. If Singularity is ON, then it will trap
all those occasions on which you delete a file by method 2 above and will
keep a copy in the Bin Directory.

Singularity is configured via the Black Hole Configuration window.
[12]

To turn Singularity on, select the 'Trap Filer Deletes' option. The other
options do the following:

Show Sprite will put an icon on the iconbar which will show if Singularity is
currently on or off. Clicking on the icon will toggle between the two.
The Singularity icon has a menu. The 'Remove' option on this menu will remove
the singularity icon from the iconbar but will NOT turn it off if it is on.

Remove at exit should be left on.

Report will make a small window open every time Singularity traps a deletion.
The window will close after a few seconds.

If 'Ignore ADFS floppy discs' is ON, Singularity will not be applied to
deletions from floppy discs. This is usually a good idea.

The bit about File Systems to Ignore can be ignored.

[34]
You should read the relevant help for information on the options.

NOTE : Earlier versions of this software did not work with third-party SCSI
or IDE filing systems, or with the RAM disc. This is now fixed.

[1234]
Compatibility Issues:
=====================

Singularity has been tested with as many filing systems as possible. Two
problems are known about:

1) Singularity cannot differentiate between an Image filing system and it's
   parent. E.g. a PC emulator DOS partition looks to Singularity like an ADFS
   disc, even though it's under the control of DOSFS.
   
2) If you use SparkFS to create archives in the 'Spark Dir' format and
   delete any files from there, Singularity will copy them over in
   COMPRESSED form. This is due to the way this type of Archive is controlled
   by SparkFS. The same may be true of certain versions of ArcFS, but I
   haven't tried it 'cos my version's read only.
   
   With normal archives (and with CFS) the files are decompressed on the fly.

